home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 22 / PC Actual CD 22.iso / linux / xfree86 / DOC / README.LynxOS < prev    next >
Encoding:
Text File  |  1998-01-07  |  22.6 KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                README for XFree86 3.3 on LynxOS
  11.  
  12.                 Thomas Mueller
  13.  
  14.              Last modified on: 26 May 1997
  15.  
  16.  
  17.  
  18. 1.  What and Where is XFree86?
  19.  
  20. XFree86 is a port of X11R6.3 that supports several versions of Intel-based
  21. Unix.  It is derived from X386 1.2, which was the X server distributed with
  22. X11R5.    This release consists of many new features and performance improvements
  23. as well as many bug fixes.  The release is available as source patches against
  24. the X Consortium X11R6.3 code, as well as binary distributions for many archi-
  25. tectures.
  26.  
  27. See the Copyright Notice in Copyright Notice.
  28.  
  29. The sources for XFree86 are available by anonymous ftp from:
  30.  
  31. ftp://ftp.XFree86.org/pub/XFree86/current
  32.  
  33. Binaries of the 3.3 release for LynxOS AT are available from:
  34.  
  35. ftp://ftp.XFree86.org/pub/XFree86/current/binaries/LynxOS
  36.  
  37. The binaries are built on `LynxOS 2.5.0 012797-G i386'. These binaries don't
  38. run on earlier LynxOS versions because of the changes made to the networking
  39. code in LynxOS 2.5.0. This XFree86 version has never been tested on LynxOS ver-
  40. sions earlier than 2.3.0.
  41.  
  42. XFree86 supports LynxOS on the AT, on the microSPARC and on the PowerPC plat-
  43. form. X servers are currently available on the AT and microSPARC platform.
  44. Refer to section Building on microSPARC and PowerPC (section 7., page 13) for
  45. details on XFree86 on the non-AT platforms.
  46.  
  47. If you need binaries for other platforms than the one on the XFree86 FTP server
  48. contact me (tm@systrix.de).
  49.  
  50. Send email to tm@systrix.de (Thomas Mueller) or XFree86@XFree86.org if you have
  51. comments or suggestions about this file and we'll revise it.
  52.  
  53.  
  54. 2.  Installing the Binaries
  55.  
  56. The binary distribution is composed of a number of  tar archives which are the
  57. executables, servers, fonts, libraries, include files, man pages, config files,
  58. and the server link kit.  The full distribution takes over 95MB of disk space.
  59.  
  60. At minimum you need to unpack the 'required' X33*.tgz archives plus at least
  61. one server that matches your vga card. If you will be using the new XF86Setup
  62.  
  63.  
  64. README for XFree86 3.3 on LynxOS
  65.  
  66.  
  67.  
  68.  
  69.  
  70. README for XFree86 3.3 on LynxOS
  71.  
  72.  
  73.  
  74. utility you will also need the VGA16 server.  You'll need about 40Mb for the
  75. minimum required run-time binaries only.
  76.  
  77.       REQUIRED:
  78.  
  79.           X33bin
  80.             Clients, run-time libs, and app-defaults files
  81.  
  82.           X33doc
  83.             Documentation
  84.  
  85.           X33fnts
  86.             75dpi and misc fonts
  87.  
  88.           X33lib
  89.             Data files required at run-time
  90.  
  91.           X33cfg
  92.             sample config files for xinit, xdm
  93.  
  94.           X33set
  95.             XF86Setup utility
  96.  
  97.           X33VG16
  98.             16 colour VGA server (XF86Setup needs this server)
  99.  
  100.         Choose at least one of the following server to match your hardware:
  101.  
  102.           X338514
  103.             8514/A server
  104.  
  105.           X33AGX
  106.             AGX server
  107.  
  108.           X33I128
  109.             I128 server
  110.  
  111.           X33Ma64
  112.             Mach 64 server
  113.  
  114.           X33Ma32
  115.             Mach 32 server
  116.  
  117.           X33Ma8
  118.             Mach 8 server
  119.  
  120.           X33Mono
  121.             Monochrome server
  122.  
  123.           X33P9K
  124.             P9000 server
  125.  
  126.           X33S3
  127.             S3 server
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. README for XFree86 3.3 on LynxOS
  137.  
  138.  
  139.  
  140.           X33S3V
  141.             S3 ViRGE server
  142.  
  143.           X33SVGA
  144.             SVGA server
  145.  
  146.           X33VG16
  147.             16 colour VGA server
  148.  
  149.           X33W32
  150.             ET4000W32, ET6000 server
  151.  
  152.       OPTIONAL:
  153.  
  154.           X33f100
  155.             100dpi fonts
  156.  
  157.           X33fcyr
  158.             Cyrillic fonts
  159.  
  160.           X33fnon
  161.             Other fonts (Chinese, Japanese, Korean, Hebrew)
  162.  
  163.           X33fscl
  164.             Scalable fonts (Speedo and Type1)
  165.  
  166.           X33fsrv
  167.             Font server and config files
  168.  
  169.           X33prog
  170.             X header files, config files and compile-time libs
  171.  
  172.           X33man
  173.             Manual pages
  174.  
  175.           X33nest
  176.             Nested X server
  177.  
  178.           X33prt
  179.             X Print server
  180.  
  181.           X33vfb
  182.             Virtual frame buffer X server
  183.  
  184.           X33lkit
  185.             The server LinkKit
  186.  
  187.           X33ps
  188.             PostScript version of the documentation
  189.  
  190.           X33html
  191.             HTML version of the documentation
  192.  
  193. If this is your first time, then you can safely install all of the packages.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. README for XFree86 3.3 on LynxOS
  203.  
  204.  
  205.  
  206. As a minimal install, you'll need doc, bin, fonts lib, config, and one X
  207. server.
  208.  
  209. If you plan to install XF86Setup you'll have to install X33prog as well since
  210. XF86Setup checks for the existence of a certain file name pattern which is sat-
  211. isfied only if you install the library files from X33prog. This restriction
  212. will be fixed in future XFree86 releases for LynxOS.
  213.  
  214. It may be necessary to increase the process stack limit in order to run XFree86
  215. on your system. Edit /etc/startab and reboot your system to make the changes
  216. active before you begin the installation.
  217.  
  218. Also, be sure to include /usr/X11R6/bin in your PATH environment variable.
  219.  
  220. 2.1  Full Install
  221.  
  222.   1.  You must be logged in as root to unpack the archives because several exe-
  223.       cutables are set-user-id.  Otherwise the server may abort if you unpack
  224.       it as an ordinary user.
  225.  
  226.   2.  If you have about 80Mb free in the /usr partition create a directory
  227.       /usr/X11R6 and skip to no. 3.  Otherwise, create a directory on another
  228.       partition and sym link it into /usr:
  229.  
  230.  
  231.         # cd /usr/local
  232.         # mkdir X11R6
  233.         # ln -s /usr/local/X11R6 /usr/X11R6
  234.  
  235.  
  236.  
  237.   3.  Unpack everything:
  238.  
  239.       If you are using bash:
  240.  
  241.  
  242.         # cd /usr/X11R6
  243.         # for i in X33*.tgz; do
  244.         #    gnutar -xzpPf $i
  245.         # done
  246.  
  247.  
  248.  
  249.       Else, if you are using csh:
  250.  
  251.         % cd /usr/X11R6
  252.         % foreach i (X33*.tgz)
  253.         %    gnutar -xzpPf $i
  254.         % end
  255.  
  256.  
  257.  
  258.   4.  Create a symbolic link ``X'' that points to the server that matches your
  259.       video card.  The XF86_* man pages list which vga chip sets are supported
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. README for XFree86 3.3 on LynxOS
  269.  
  270.  
  271.  
  272.       by each server.  For example, if you have an ET4000 based card you will
  273.       use the XF86_SVGA server:
  274.  
  275.  
  276.         # cd /usr/X11R6/bin; rm -f X; ln -s XF86_SVGA X
  277.  
  278. 2.2  Minimal Install
  279.  
  280. First do numbers 1 and 2 above. Then unpack the required archives:
  281.  
  282.       # cd /usr/X11R6
  283.       # for i in bin fnts lib xicf; do
  284.       #   gnutar -xzpPf  X33$i.tgz
  285.       # done
  286.  
  287. Then unpack a server archive corresponding to your vga card.  The server man
  288. pages, X11R6/man/man1/XF86_*, list the vga chip sets supported by each server.
  289. For example, if you have an ET4000 based card you will use the XF86_SVGA
  290. server:
  291.  
  292.       # gnutar -xzpPf X33SVGA.tgz
  293.       # cd /usr/X11R6/bin; rm -f X; ln -s XF86_SVGA X
  294.  
  295. 2.3  After either Full or Minimal Install above
  296.  
  297. Be sure to include /usr/X11R6/bin in your PATH environment variable. If you
  298. plan to use clients of the MetroLink X package with the XFree86 X server make
  299. sure to remove /usr/bin/X11/X file or put /usr/bin/X11 after /usr/X11R6/bin in
  300. your PATH environment variable.
  301.  
  302. If you had already configured X11R6/lib/X11/xinit/xinitrc or
  303. X11R6/lib/X11/xdm/* omit the xinit-config or xdm-config archive or unpack it
  304. separately and merge in your customizations.
  305.  
  306. The fscl, fcyr and f100 font archives are optional and can be omitted if you
  307. are short on space.  The optional lkit archive allows you to reconfigure and
  308. customize a X server binary.
  309.  
  310. The optional prog archive is needed only for writing or compiling X applica-
  311. tions. Before building programs check wether X11R6/lib/X11/config/lynx.cf has
  312. correct settings for OSMajorVersion, OSMinorVersion and OSTeenyVersion for your
  313. operating system version.
  314.  
  315. Refer to section Running XFree86 (section 4., page 9) for further information
  316. on necessary configuration steps before running XFree86 on LynxOS.
  317.  
  318.  
  319. 3.  Compiling the XFree86 Distribution
  320.  
  321. 3.1  Disk space requirements
  322.  
  323. Currently there is no support for shared libraries in the LynxOS XFree86 port.
  324. A complete binary installation along with manual pages will require approxi-
  325. mately 90-100 MBytes of disk space. To compile the system you will need at
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. README for XFree86 3.3 on LynxOS
  335.  
  336.  
  337.  
  338. least 230 MBytes of free disk space.
  339.  
  340. 3.2  Changes to system environment (LynxOS AT)
  341.  
  342. Before compiling the XFree86 distribution you will have to make a few little
  343. adjustments to your system:
  344.  
  345.       LynxOS AT 2.5
  346.  
  347.            o Create a shell script named /lib/cpp as follows:
  348.  
  349.               #!/bin/sh
  350.               /usr/lib/gcc-lib/i386-unknown-lynxos2.5/2.7-96q1/cpp \
  351.                  -traditional "$@"
  352.  
  353.  
  354.  
  355.          On other platforms than the AT the paths for the compiler sup-
  356.          port programs are different. You may use
  357.  
  358.                gcc -v
  359.  
  360.  
  361.  
  362.          to find out the correct path. Set the file mode of /lib/cpp
  363.          with
  364.  
  365.                # chown root /lib/cpp
  366.                # chmod 755 /lib/cpp
  367.  
  368.  
  369.            o Modify /lib/liblynx.a. The X servers need the smem_create()
  370.          system call to map the frame buffer into their address space.
  371.          The system call is in liblynx library along with other Lynx
  372.          proprietary calls which (unfortunately) overlap with calls in
  373.          libc. To reduce confusion you should modify liblynx as fol-
  374.          lows:
  375.  
  376.               # mv /lib/liblynx.a /lib/liblynx.a.ORG
  377.               # mkdir /tmp/xx; cd /tmp/xx
  378.               # ar xv /lib/liblynx.a.ORG
  379.               # ar rv /lib/liblynx.a *smem*
  380.               # ranlib /lib/liblynx.a
  381.  
  382.  
  383.  
  384.  
  385.       LynxOS AT 2.3 and 2.4
  386.  
  387.            o Use the CYGNUS GNU-C Compiler to build XFree86. With LynxOS
  388.          2.3.0 and 2.4.0 you must execute the shell script /CYGNUS.bash
  389.          to apply the necessary changes to your environment.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. README for XFree86 3.3 on LynxOS
  401.  
  402.  
  403.  
  404.            o Create a shell script named /lib/cpp as follows:
  405.  
  406.               #!/bin/sh
  407.               /cygnus/94q4-lynxos-x86/lib/gcc-lib/i386-lynx/2.6-94q4/cpp \
  408.                  -traditional "$@"
  409.  
  410.  
  411.  
  412.          It is possible that future releases use a different path for
  413.          the CYGNUS compiler support programs. You may use
  414.  
  415.                gcc -v
  416.  
  417.  
  418.  
  419.          to find out the correct path. Set the file mode of /lib/cpp
  420.          with
  421.  
  422.                # chown root /lib/cpp
  423.                # chmod 755 /lib/cpp
  424.  
  425.  
  426.       LynxOS AT 2.2.1
  427.         This has actually never been tested, be prepared that the build
  428.         will fail somewhere!
  429.  
  430.            o Create a shell script named /lib/cpp as follows:
  431.  
  432.               #!/bin/sh
  433.               /usr/local/lib/gcc-cpp -traditional "$@"
  434.  
  435.  
  436.            o The loader /bin/ld of LynxOS 2.2.1 does not support the -L
  437.          option which is heavily used by X11R6 makefiles. To work
  438.          around this problem you must install a small wrapper program
  439.          which replaces the original /bin/ld program. Use the following
  440.          steps to install it:
  441.  
  442.                 # cd xc/programs/Xserver/hw/xfree/etc
  443.                 # cc -o ld ld-wrapper.c
  444.                 # mv /bin/ld /bin/ld.org
  445.                 # mv ld /bin/ld
  446.                 # chmod 511 /bin/ld
  447.                 # chown root /bin/ld
  448.  
  449.  
  450.            o Modify system header files as follows:
  451.  
  452.                /usr/include/uio.h
  453.                  surrounded by
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. README for XFree86 3.3 on LynxOS
  467.  
  468.  
  469.  
  470.                         #ifndef _UIO_H
  471.                         #define _UIO_H
  472.                         ...
  473.                         #endif
  474.  
  475.  
  476.                /usr/include/utmp.h
  477.                  surrounded by
  478.  
  479.                         #ifndef _UTMP_H
  480.                         #define _UTMP_H
  481.                         ...
  482.                         #endif
  483.  
  484.  
  485.                /usr/include/unistd.h
  486.                  add
  487.  
  488.                         extern int read();
  489.  
  490.  
  491. 3.3  make World
  492.  
  493. Before you start compilation you must edit xc/config/cf/lynx.cf to match your
  494. operating system version (defaults set up for 2.5.0). Change the definitions of
  495. OSMajorVersion, OSMinorVersion and OSTeenyVersion accordingly.
  496.  
  497. You may now issue a
  498.  
  499.       make World
  500.  
  501.  
  502. to compile XFree86. After a few hours (and hopefully a successful build of the
  503. XFree86 system) you can install the software using
  504.  
  505.       make install
  506.  
  507.  
  508. You must be logged in as super-user (root) when you invoke `make install'.  Be
  509. sure to set your environment to use the same compiler (LynxOS 2.3.0/2.4.0,
  510. CYGNUS GNU-C) as you did during the `make World'. To install the LinkKit use
  511.  
  512.       make install.linkkit
  513.  
  514.  
  515. With LynxOS 2.2.1 programs will not be stripped during installation. This is
  516. due to a problem with the strip program which shows up when installing across
  517. file system boundaries.
  518.  
  519. Refer to section Installing XFree86 manual pages (section 5., page 11) for man-
  520. ual page installation.
  521.  
  522. On LynxOS AT 2.5.0 you may encounter problems with make in deeply nested subdi-
  523. rectories (eg core dumps, hangups). In this case update to GNU make version
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. README for XFree86 3.3 on LynxOS
  533.  
  534.  
  535.  
  536. 3.75 or higher.
  537.  
  538.  
  539. 4.  Running XFree86
  540.  
  541. 4.1  System requirements
  542.  
  543. A minimum of 8MB of memory is required to run X. If you want to run real-world
  544. applications you should think of upgrading to 16MB. If you plan to develop
  545. software under X take 32MB into consideration.
  546.  
  547. 4.2  System tuning
  548.  
  549. 4.2.1  Tunable parameters
  550.  
  551. To reasonably run XFree86 you may have to adjust a few system parameters.
  552.  
  553. On LynxOS 2.5.0 include a line
  554.  
  555.        #define X_WINDOWS
  556.  
  557. in /sys/lynx.os/uparam.h.
  558.  
  559. For earlier versions you'll have to edit /usr/include/param.h:
  560.  
  561.        Tunable                         Old     New
  562.        USR_NFDS      number of open files per process      20      64
  563.        NPROC         number of tasks              50     150
  564.        NFILES         number of open files in system     100     250
  565.        NINODES         number of incore inodes         (same value as NFILES)
  566.        QUANTUM         clock ticks until preemption      64      20
  567.        CACHEBLKS     number of cache memory blocks     202      >= 4096
  568.  
  569. The new values are those suggested by the LynxOS documentation for their X Win-
  570. dow package.
  571.  
  572. 4.2.2  Increase number of ptys
  573.  
  574. You should also increase the number of ptys to be able run a couple more
  575. xterms. You may replace /sys/lynx.os/pty.cfg with
  576. /usr/X11R6/lib/X11/etc/pty.cfg.
  577.  
  578. 4.2.3  Kernel build
  579.  
  580. If you plan to use PS/2 or Bus mice refer to the following section before
  581. rebuilding the kernel, if not, you should rebuild the kernel now:
  582.  
  583.       # cd /sys/lynx.os
  584.       # make install
  585.       # reboot -N
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. README for XFree86 3.3 on LynxOS
  599.  
  600.  
  601.  
  602. 4.3  Bus mouse drivers
  603.  
  604. Starting with LynxOS AT 2.4.0 LynxOS includes a PS/2 mouse driver.  Currently
  605. this driver is not fully supported by XFree86 (you'll probably have to specify
  606. a mouse type which doesn't match the real mouse type and in some cases lose
  607. mouse buttons).  /usr/X11R6/lib/X11/etc/BM-Lynx.shar contains a LynxOS port of
  608. the Linux bus mouse drivers. To install the drivers unpack the shar archive
  609.  
  610.      # cd /
  611.      # bash /usr/X11R6/lib/X11/etc/BM-Lynx.shar
  612.  
  613.  
  614. and follow the notes in /BMOUSE.Readme for further installation and configura-
  615. tion notes.
  616.  
  617. The XFree86 PS/2 mouse driver works also with MetroLink X 2.3.3.1 as shipped
  618. with LynxOS AT 2.4.0 unless you have the LynxOS patch 000055-00 installed.
  619.  
  620. 4.4  ATC console driver and VT switching
  621.  
  622. The XFree86 servers will only run with the default LynxOS console driver, sorry
  623. for those of you who use the alternative vdt console driver. Currently there is
  624. no support for virtual terminal switching once the server has started.
  625.  
  626. You will need a free console which the X server will use for keyboard input.
  627. You must disable login on at least one of the four virtual terminals in
  628. /etc/ttys, e.g. /dev/atc3:
  629.  
  630. change
  631.  
  632.         /dev/atc3:1:default:vt100at:/bin/login
  633.  
  634.  
  635.  
  636. to
  637.  
  638.         /dev/atc3:0:default:vt100at:/bin/login
  639.               ^
  640.  
  641.  
  642. 4.5  X Server debug diagnostics output and other VT peculiarities
  643.  
  644. The XFree86 X servers will produce a lot of diagnostics output on stderr during
  645. startup. This output will be lost after the server reached a certain point in
  646. its console initialization process. You should redirect stdout and stderr if
  647. you want to analyze the diagnostics produced by the server.
  648.  
  649. When the X server is running output made to other consoles will be lost. After
  650. server shutdown the screen contents of other consoles may be inconsistent with
  651. what one would expect (i.e. random).
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. README for XFree86 3.3 on LynxOS
  665.  
  666.  
  667.  
  668. 5.  Installing XFree86 manual pages
  669.  
  670. LynxOS uses cat-able manual pages, and because a doc preparation system is def-
  671. initely not a vital component of a real-time operating system you must first
  672. install groff-1.09 (or newer). Starting with LynxOS 2.3.0 it should compile
  673. right out of the box (or better tar archive).
  674.  
  675. XFree86 manual pages may be installed using
  676.  
  677.       make install.man
  678.  
  679.  
  680. The index and whatis database for the XFree86 manual pages will be created
  681. automatically. If you already have a whatis database or index file in the des-
  682. tination directories you should perform a sort/uniq operation to remove dupli-
  683. cate entries:
  684.  
  685.       for i in 1 3 5
  686.       do
  687.         rm -f /tmp/tmpfile
  688.         sort /usr/X11R6/man/cat$i/LIST$i | uniq > /tmp/tmpfile
  689.         mv /tmp/tmpfile /usr/X11R6/man/cat$i/LIST$i
  690.       done
  691.       sort /usr/X11R6/man/whatis | uniq > /tmp/tmpfile
  692.       mv /tmp/tmpfile /usr/X11R6/man/whatis
  693.  
  694.  
  695. With LynxOS 2.3.0 you should include /usr/X11R6/man in the MANPATH environment
  696. variable.
  697.  
  698.      bash:   MANPATH=$MANPATH:/usr/X11R6/man
  699.  
  700. The man command of LynxOS 2.2.1 does not support the MANPATH environment vari-
  701. able properly. The XFree86 manual pages must be copied (or linked) to the stan-
  702. dard manual page locations (/usr/man/catx) in  order to be read the man com-
  703. mand:
  704.  
  705.        for i in 1 3 5
  706.        do
  707.          ln -s /usr/X11R6/man/cat$i/*.* /usr/man/cat$i
  708.          cat /usr/X11R6/man/cat$i/LIST$i >> /usr/man/cat$i/LIST$i
  709.          sort -o /usr/man/cat$i/LIST$i /usr/man/cat$i/LIST$i
  710.          cat /usr/X11R6/man/cat$i/whatis$i >> /usr/man/whatis
  711.        done
  712.  
  713.  
  714.  
  715. 6.  Using XFree86 with Motif
  716.  
  717. The Motif libraries shipped with LynxOS AT 2.3.0 and 2.4.0 can be used with the
  718. XFree86 libraries. Follow the steps outlined below after you have installed
  719. XFree86 and LynxOS Motif on your system.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. README for XFree86 3.3 on LynxOS
  731.  
  732.  
  733.  
  734. 6.1  Copy Motif files
  735.  
  736. You must create symbolic links for the Motif libraries and utilities in the
  737. /usr/X11R6 directory tree.
  738.  
  739.        ln -s /usr/bin/X11/uil /usr/X11R6/bin
  740.        ln -s /usr/lib/libUil.a /usr/X11R6/lib
  741.        ln -s /usr/lib/libMrm.a /usr/X11R6/lib
  742.        ln -s /usr/lib/libXm.a /usr/X11R6/lib
  743.        ln -s /usr/lib/X11/uid /usr/X11R6/lib/X11
  744.        ln -s /usr/include/Xm /usr/X11R6/include
  745.        ln -s /usr/include/Mrm /usr/X11R6/include
  746.        ln -s /usr/include/uil /usr/X11R6/include
  747.  
  748.  
  749. The Motif imake-configuration files are part of the LynxOS X Window package.
  750. They must be copied to the /usr/X11R6 directory tree.
  751.  
  752.        cp /usr/lib/X11/config/Motif.* /usr/X11R6/lib/X11/config
  753.  
  754.  
  755. 6.2  Motif library patch for LynxOS AT 2.3.0
  756.  
  757. The XFree86 libraries are compiled with the -mposix compiler option while the
  758. Motif libraries shipped with LynxOS AT 2.3.0 are not. This incompatibility will
  759. cause Motif XmFileSelection widgets to be linked with the wrong (i.e. POSIX)
  760. directory routines. To circumvent this problem apply the following patch to the
  761. library:
  762.  
  763.        cp /usr/lib/libXm.a /usr/X11R6/lib
  764.        ar x /usr/X11R6/lib/libXm.a Xmos.o
  765.        ar x /lib/libc.a directory.s.o
  766.        ld -r -o x.o Xmos.o directory.s.o
  767.        mv x.o Xmos.o
  768.        ar r /usr/X11R6/lib/libXm.a Xmos.o
  769.  
  770.  
  771. This patch is not necessary for LynxOS revisions after 2.3.0.
  772.  
  773. 6.3  X11R6 config file patch
  774.  
  775. Edit /usr/X11R6/lib/X11/config/lynx.cf and change the definition of HasMotif
  776. from
  777.  
  778.         #define HasMotif    NO
  779.  
  780.  
  781.  
  782. to
  783.  
  784.         #define HasMotif    YES
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. README for XFree86 3.3 on LynxOS
  797.  
  798.  
  799.  
  800. 6.4  Motif config file patch
  801.  
  802. The file Motif.tmpl shipped with LynxOS Motif must be modified to work with
  803. XFree86. In every reference to UnsharedLibReferences the first argument must be
  804. changed from
  805.  
  806.         UnsharedLibReferences(<Something>LIB, Arg2, Arg3)
  807.  
  808.  
  809.  
  810. to
  811.  
  812.         UnsharedLibReferences(<Something>, Arg2, Arg3)
  813.  
  814.  
  815.  
  816. Be sure to apply the change to the file copied to /usr/X11R6/lib/X11/config.
  817.  
  818.  
  819. 7.  Building on microSPARC and PowerPC
  820.  
  821. XFree86 3.3 compiles on LynxOS microSPARC and on LynxOS PPC as well. On the
  822. microSPARC there is X server support for the colour frame buffers CG3 and CG6
  823. while on the PPC there is no X server available at this time. Before you start
  824. the build (on versions earlier than 2.5.0) you must create a symbolic link from
  825. the CYGNUS gcc to a file named cc somewhere in a directory included in your
  826. PATH environment variable.
  827.  
  828. 7.1  Console driver patch for microSPARC
  829.  
  830. Before building on the microSPARC you should install the patch for the console
  831. driver supplied in xc/programs/Xserver/hw/sunLynx/patch.Console.  (xc/pro-
  832. grams/Xserver/hw/sunLynx/patch.Console-2.4.0 for LynxOS revisions earlier than
  833. 2.5.0).  The patch fixes minor problems in the original LynxOS driver and adds
  834. functionalities to detect the keyboard type and control the key click.    To cre-
  835. ate a backup of the original driver and install the patch issue the commands
  836.  
  837.       # cd /
  838.       # tar cf /sys/drivers/console.tar /sys/drivers/console
  839.       # patch -p -E < xc/programs/Xserver/hw/sunLynx/patch.Console
  840.       # cd /sys/drivers/console
  841.       # make install
  842.       # cd /sys/lynx.os
  843.       # make install
  844.       # reboot -a
  845.  
  846. If you opt not to install the patch you must edit xc/config/cf/lynx.cf and
  847. change the definition of SparcConsoleDefines from
  848.  
  849.         #define SparcConsoleDefines    -DPATCHED_CONSOLE
  850.  
  851.  
  852.  
  853. to
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. README for XFree86 3.3 on LynxOS
  863.  
  864.  
  865.  
  866.         #define SparcConsoleDefines    /* -DPATCHED_CONSOLE */
  867.  
  868.  
  869. 7.2  Known Bug of the microSPARC server
  870.  
  871. On the first start of the X server on the microSPARC you will notice that the
  872. pointer follows mouse movements with a certain delay (especially if you're mov-
  873. ing the mouse real fast). You will also notice that moving windows with certain
  874. window managers (eg mwm) is not working correctly.  These effects should go
  875. away on the next server start.
  876.  
  877. The server for monochrome cards builds properly if you enable it in lynx.cf but
  878. it has never been tested (reports are welcome).
  879.  
  880.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/LynxOS.sgml,v 3.14.2.2 1997/05/26 14:36:18 dawes Exp $
  881.  
  882.  
  883.  
  884.  
  885.  
  886.      $XConsortium: LynxOS.sgml /main/10 1996/10/28 05:13:07 kaleb $
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. README for XFree86 3.3 on LynxOS
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.                    CONTENTS
  999.  
  1000.  
  1001.  
  1002. 1. What and Where is XFree86? ............................................... 1
  1003.  
  1004. 2. Installing the Binaries .................................................. 1
  1005.    2.1 Full Install ......................................................... 4
  1006.    2.2 Minimal Install ...................................................... 5
  1007.    2.3 After either Full or Minimal Install above ........................... 5
  1008.  
  1009. 3. Compiling the XFree86 Distribution ....................................... 5
  1010.    3.1 Disk space requirements .............................................. 5
  1011.    3.2 Changes to system environment (LynxOS AT) ............................ 6
  1012.    3.3 make World ........................................................... 8
  1013.  
  1014. 4. Running XFree86 .......................................................... 9
  1015.    4.1 System requirements .................................................. 9
  1016.    4.2 System tuning ........................................................ 9
  1017.    4.3 Bus mouse drivers ................................................... 10
  1018.    4.4 ATC console driver and VT switching ................................. 10
  1019.    4.5 X Server debug diagnostics output and other VT peculiarities ........ 10
  1020.  
  1021. 5. Installing XFree86 manual pages ......................................... 11
  1022.  
  1023. 6. Using XFree86 with Motif ................................................ 11
  1024.    6.1 Copy Motif files .................................................... 12
  1025.    6.2 Motif library patch for LynxOS AT 2.3.0 ............................. 12
  1026.    6.3 X11R6 config file patch ............................................. 12
  1027.    6.4 Motif config file patch ............................................. 13
  1028.  
  1029. 7. Building on microSPARC and PowerPC ...................................... 13
  1030.    7.1 Console driver patch for microSPARC ................................. 13
  1031.    7.2 Known Bug of the microSPARC server .................................. 14
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                        i
  1055.  
  1056.  
  1057.